NewGenerate AI UGC videos with your AI agent using agent-media

Run Your Social Media from Paperclip with Postiz

Paperclip agents can schedule and publish social media posts through Postiz. Install the Postiz skill in the environment where your agents run, connect your channels in Postiz, and any agent in your Paperclip org can draft, review, and post to 30+ platforms from a single task, with approvals and budgets keeping a human in the loop.

View Docs Paperclip

Please make sure there is always a human in the loop.

Last updated: September 2026

Set Up Once, Then Just Ask

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Paperclip:
> List my connected social media accounts
> Post "Hello from Postiz!" to X and LinkedIn,
  schedule it for tomorrow at 9am

Paperclip: Done! Scheduled on X and LinkedIn
  for tomorrow at 9:00 AM.

Why use Postiz with Paperclip?

Postiz gives Paperclip agents one tool for every social channel, with structured output they can verify, so a posting pipeline needs no per-platform code.

🤖

AI Agent Ready

Postiz returns structured results, so Paperclip can plan, run, and verify multi-step social media workflows on its own.

🌐

30+ Platforms

Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms. One request from you, Paperclip handles every platform.

🧵

Threads & Comments

Create threaded posts with multiple comments, each with their own media. Automatic conversion to platform-native threads.

📷

Rich Media Support

Upload and attach images, videos, audio, and documents. Supports PNG, JPG, MP4, MOV, PDF, and many more formats.

📅

Scheduled Posting

Schedule posts with precise timestamps, create drafts for review, and batch schedule entire content campaigns.

⚙️

Platform-Specific Settings

Dynamic discovery of platform features like Reddit flairs, YouTube playlists, Pinterest boards, and LinkedIn company pages.

How does Paperclip post to social media with Postiz?

You assign a task in plain language and the Paperclip agent translates it into Postiz CLI calls: list channels, upload media, create the post, check results. Here is how a typical exchange goes.

Discover Integrations

List all your connected social media accounts and discover platform-specific features like subreddit flairs and YouTube playlists.

Example conversation

> What social accounts do I have connected?

Paperclip: You have 4 channels connected:
  X, LinkedIn, Reddit, and YouTube.
  I can also check platform options like
  subreddit flairs or YouTube playlists.

Create Posts

Describe the post — content, media, comments, and any platform options — and Paperclip builds it, from a quick one-liner to a full campaign.

Example conversation

> Post "Check out our new feature!" with
  screenshot.png to X and LinkedIn,
  tomorrow at 9am

Paperclip: Done! Scheduled on X and LinkedIn
  for tomorrow at 9:00 AM with the image.

Manage & Analyze

List, filter, and manage your scheduled posts. Track performance with platform and post-level analytics. Ask for a week of content and Paperclip schedules the whole campaign.

Example conversation

> What's scheduled this week, and how did
  last month's posts perform?

Paperclip: 5 posts scheduled Mon-Fri.
  Last 30 days: 12.4k impressions, up 18%.
  Your best post was Tuesday's launch thread.

One Request, Every Platform

Ask once and Paperclip posts to every platform at the same time, each with its own media and settings. For example:

Example

> Post "Launching our new feature today!" with
  banner.png to X, LinkedIn, and Facebook tomorrow
  at 9am. On Reddit, post it to r/programming as a
  text post titled "New Tutorial". Then schedule a
  daily tip on X and LinkedIn for the rest of the week.

Paperclip: Done! Here's what I scheduled:
  - X, LinkedIn, Facebook: tomorrow 9:00 AM (banner.png)
  - Reddit r/programming: tomorrow 9:00 AM, "New Tutorial"
  - Daily tips: Mon-Fri 9:00 AM on X and LinkedIn

What is Paperclip?

Paperclip is an open-source, MIT-licensed platform for managing teams of AI agents at work, described by its makers as orchestration for "zero-human companies". It organizes agents such as Claude Code, Codex, Cursor, and OpenClaw into an org chart with goals, budgets, approval workflows, and heartbeat schedules, all self-hosted with no Paperclip account required. Postiz is the tool those agents use for social media.

👥

Agent Teams

Manages teams of AI agents working together. Assign content, scheduling, and review agents to handle your entire social media workflow collaboratively.

📊

Single Dashboard

Monitor all agents and tasks from one unified dashboard. Track content pipelines, scheduling status, and agent performance in real time.

⚙

Orchestration

Chain multi-agent workflows with approval gates and handoffs. Build sophisticated content pipelines where agents collaborate on drafting, reviewing, and publishing.

How Postiz Works with Paperclip

Postiz integrates as a tool in Paperclip's orchestration framework. Once configured, your agent teams can call Postiz commands as part of multi-step workflows — from content creation to cross-platform publishing.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz capabilities to specialized agents
✓Orchestrate multi-step workflows with approval chains
✓Monitor all social media activity from the Paperclip dashboard

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# tool integration and assigns it
# to your agent teams

Orchestrated Social Media

Let Paperclip coordinate your agent teams to handle the entire social media pipeline — from content creation to review to publishing across all your platforms.

📎

Multi-Agent Flow

Coordinated agent teams

Paperclip coordinates multiple agents to handle the complete content lifecycle. The Content Agent drafts, the Review Agent approves, and the Scheduling Agent publishes — all orchestrated automatically.

Paperclip Pipeline

Content Agent: Drafting post about
  our new feature launch...
  -> Generated 3 platform variants

Review Agent: Reviewing drafts...
  -> Twitter variant: Approved
  -> LinkedIn variant: Minor edit applied
  -> Reddit variant: Approved

Scheduling Agent: Publishing via Postiz
  1. Uploading media assets
  2. Scheduling across 3 platforms

  Done! Posts scheduled:
  - X (Twitter): scheduled 9:00 AM
  - LinkedIn: scheduled 9:00 AM
  - Reddit (r/programming): scheduled 9:30 AM

📎

Content Pipelines

Declarative workflow config

Define your content pipeline in a paperclip.yaml file. Assign roles to agents and let Paperclip orchestrate the entire flow from creation to publishing.

paperclip.yaml

pipeline: social_media
schedule: "weekdays 9am"
tools:
  - postiz-agent

roles:
  content_creator:
    task: "Draft platform-specific posts"
    output: drafts/

  reviewer:
    task: "Review and approve drafts"
    requires: content_creator
    approval: true

  publisher:
    task: "Schedule approved posts via Postiz"
    requires: reviewer
    platforms:
      - twitter
      - linkedin
      - reddit

Why Paperclip + Postiz

✓Multi-agent teams — coordinate content, review, and publishing agents
✓Single dashboard — monitor all agents and social media tasks
✓Orchestrated pipelines — chain agent workflows with approval gates
✓Scheduled pipelines — automate recurring content workflows
✓Cross-post to 30+ platforms from coordinated agent teams
✓Open-source — both Paperclip and Postiz are fully open-source

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
metadata:
  paperclip:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Claude Code, Anthropic's agentic coding tool.

Claude Code

Anthropic's agentic coding tool

Claude Code reads the Postiz skill so it knows what it can do. It autonomously discovers your integrations, uploads media, composes posts with platform-specific settings, and schedules content across all your connected platforms.

Claude Code

> Schedule a tweet for tomorrow morning
  announcing our new feature, attach
  the screenshot from ./assets/launch.png

Claude Code: Done! Scheduled on X for
  tomorrow at 9:00 AM.

What can you ask Paperclip to do with Postiz?

Anything the Postiz CLI can do: list channels, fetch platform options, create and schedule posts, cancel them, upload media, and pull analytics. A few tasks people assign to Paperclip agents.

You say	What happens
`Which accounts do I have connected?`	Lists every connected social channel
`What options does my Reddit channel support?`	Shows platform-specific settings like flairs or playlists
`What flairs are available in r/programming?`	Fetches live platform data before posting
`Post this to X and LinkedIn tomorrow at 9am`	Creates and schedules a post across channels
`What's scheduled for this week?`	Lists scheduled and published posts
`Cancel tomorrow's LinkedIn post`	Deletes a scheduled post
`How did my X account do last month?`	Pulls channel analytics for any period
`How is yesterday's launch post performing?`	Pulls analytics for a single post
`Upload cover.png so I can reuse it later`	Uploads media and keeps it ready for future posts

How do I connect Postiz to Paperclip?

Four steps, about ten minutes. The Postiz skill goes wherever your Paperclip agents actually execute, and your social accounts stay connected inside Postiz.

Install Paperclip

Paperclip is self-hosted and needs no account. Use the installer from paperclip.ing, or start an instance with npx. Then add the agents you want to manage, such as Claude Code or Codex.

Terminal

# Managed install
curl -fsSLO https://paperclip.ing/install.sh
bash install.sh

# Or without a permanent install
npx paperclipai onboard

Install the Postiz skill where agents run

The skill installs the postiz CLI and a SKILL.md the agent reads to learn the commands. Run it in the execution environment of each agent that should post, not only on your laptop.

Agent environment

npx skills add gitroomhq/postiz-agent

# Check the CLI is on the path
postiz --help

Authenticate to Postiz

Create an API key in Postiz under Settings, Developers, Public API, or log in with OAuth from the CLI. Connect your social channels in the Postiz dashboard; agents never hold those logins.

Agent environment

# Option A: API key
export POSTIZ_API_KEY=your_api_key

# Option B: OAuth login
postiz auth:login

# Verify
postiz integrations:list

Assign a posting task

Give an agent a goal in Paperclip. It discovers your channels, uploads media, creates the post with the right platform settings, and reports back in the dashboard for approval.

Paperclip task

> Post the launch thread to X and LinkedIn
  tomorrow at 9am, then report the post IDs

Agent: Uploaded banner.png, scheduled on
  X and LinkedIn for 9:00 AM. Post IDs
  attached to this ticket for review.

Should Paperclip agents use the Postiz CLI or the MCP server?

Use the CLI skill for agents that run shell commands on a schedule; use the MCP server for chat-first agents that support MCP. Both reach the same Postiz account and channels.

Aspect	Postiz CLI skill	Postiz MCP server
How the agent reaches Postiz	Runs the postiz CLI installed by the skill (npx skills add gitroomhq/postiz-agent)	Calls tools on the hosted MCP server at mcp.postiz.com/mcp-oauth-dynamic
Authentication	POSTIZ_API_KEY from Postiz Settings, Developers, Public API, or postiz auth:login (OAuth)	OAuth in the browser when the agent connects; no key in the environment
Works with Paperclip agents that	Can run shell commands: Claude Code, Codex, and other CLI adapters	Support MCP servers natively (Claude, Cursor, ChatGPT and similar clients)
Media upload	postiz upload <file> from the agent's machine	Upload from a URL or through the MCP upload tools
Best for	Headless pipelines, cron-style heartbeats, self-hosted Postiz	Chat-first agents and quick setup without a local install

Details on the MCP option are on the Postiz MCP server page. For agents outside Paperclip, see Postiz for any AI agent.

Which platforms can Paperclip post to?

Postiz supports 30+ channels, and these 25 have a dedicated Paperclip guide with example prompts, a settings reference, platform rules, and an FAQ.

X (Twitter)

→

Tweets, threads, and reply controls

→

Professional posts and image carousels

Instagram

→

Feed posts, stories, and reels

Facebook

→

Text posts, links, and media

→

Subreddits, flairs, and post types

YouTube

→

Video uploads, thumbnails, and tags

TikTok

→

Videos, privacy, duets, and stitches

→

Pins, boards, and link pins

Discord

→

Channel messaging and media

Slack

→

Channel messaging and team updates

→

Bot-powered channel messaging

Twitch

→

Chat messages and announcements

Kick

→

Chat messages and notifications

Medium

→

Articles, publications, and tags

Dev.to

→

Developer articles and organizations

Hashnode

→

Blog posts and publications

WordPress

→

Posts, pages, and featured images

Dribbble

→

Design shots and team portfolios

Warpcast

→

Farcaster casts and channels

Lemmy

→

Federated community posts

Moltbook

→

AI agent social network

Google My Business

→

Business posts, events, and offers

Listmonk

→

Email campaigns and newsletters

Skool

→

Community posts and groups

Whop

→

Company forums and experiences

Is it safe to let Paperclip agents post for you?

Yes, if you keep credentials in Postiz and decisions in Paperclip. Agents never see your social logins, and every post can pass an approval gate before it is scheduled.

✓Social networks are connected to Postiz once with OAuth. Agents hold only a Postiz API key or CLI login, which you can revoke in Postiz Settings at any time.
✓Paperclip adds approval workflows, per-agent budgets that stop agents at a limit, and an audit log of what each agent did.
✓Schedule posts a little ahead of time instead of publishing immediately, so a reviewer can still cancel with "cancel tomorrow's LinkedIn post".
✓Self-host both Postiz and Paperclip if your content must stay on your own infrastructure. Both are open source.

Paperclip and Postiz: frequently asked questions

Short answers to what teams ask before wiring social media into a Paperclip org.

What is Paperclip?

Paperclip is an open-source, MIT-licensed platform for managing teams of AI agents at work. It arranges agents such as Claude Code, Codex, Cursor, and OpenClaw into an org chart with goals, budgets, approval workflows, and heartbeat schedules. It is self-hosted and needs no Paperclip account. Postiz is one of the tools those agents can use.

How do I connect Postiz to Paperclip?

Install the Postiz skill with npx skills add gitroomhq/postiz-agent in the environment where your Paperclip agent executes, then set POSTIZ_API_KEY or run postiz auth:login. Connect your social channels in the Postiz dashboard. From then on, any task you assign in Paperclip that mentions posting is carried out through Postiz.

Is Paperclip the same as OpenClaw?

No. OpenClaw is an individual agent runtime; Paperclip is the layer that organizes many agents into a company, and it can run OpenClaw as one of them. The Paperclip team puts it as: if OpenClaw is an employee, Paperclip is the company. Postiz works with both, through the CLI skill or the MCP server.

Which Paperclip agents can post to social media with Postiz?

Any agent Paperclip can run. Claude Code and Codex adapters use the Postiz CLI skill directly. MCP-capable agents can connect to the hosted Postiz MCP server instead. The agent only needs a Postiz API key or OAuth login; your social accounts stay connected inside Postiz, never in the agent's environment.

Can Paperclip post to social media on a schedule without me?

Yes, with guardrails. Paperclip wakes agents on heartbeats, and Postiz schedules each post for an exact time, so a daily or weekly routine runs unattended. Use Paperclip's approval workflows and per-agent budgets so a reviewer agent or a person signs off before anything is published under your brand.

Which social platforms can Paperclip post to through Postiz?

Postiz supports 30+ channels. This site has a Paperclip guide for 25 of them: X, LinkedIn, Instagram, Facebook, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Twitch, Kick, Medium, Dev.to, Hashnode, WordPress, Dribbble, Warpcast, Lemmy, Moltbook, Google My Business, Listmonk, Skool, and Whop. Each guide lists that platform's settings and example prompts.

How much does it cost to use Postiz with Paperclip?

Paperclip is free and open source under the MIT license. Postiz Cloud has a 7-day free trial, and the open-source Postiz can be self-hosted on your own server at no cost, with the same CLI and public API. Pricing for the cloud plans is on the Postiz pricing page.

Is it safe to give Paperclip agents access to my social accounts?

Agents never receive your social logins. You connect each network to Postiz with OAuth once, and agents hold only a Postiz API key or a CLI login that you can revoke in Postiz Settings. Combine that with Paperclip's approval gates and budgets, and keep a human in the loop for anything public.

Why does my Paperclip agent say the postiz command is missing?

The skill has to be installed in the environment where that agent actually executes, not only on your laptop. Run npx skills add gitroomhq/postiz-agent there, confirm POSTIZ_API_KEY is set for that process, and test with postiz integrations:list. If posts fail in bursts, check the Postiz rate limit on post creation (self-hosted admins can raise it with API_LIMIT).